NOMBRE¶

clearenv - limpia el entorno

SINOPSIS¶

#include <stdlib.h>

int clearenv(void);

DESCRIPCIÓN¶

La función clearenv() borra todos los pares nombre-valor del entorno y establece el valor de la variable externa environ a NULL.

VALOR DEVUELTO¶

La función clearenv() devuelve cero en caso de éxito, y un valor distinto de cero en caso de fallo.

DISPONIBILIDAD¶

No está presente en libc4, libc5. En glibc está presente desde la versión 2.0.

CONFORME A¶

Varias variantes Unix (DGUX, HPUX, QNX, ...). POSIX.9 (enlaces para FORTRAN77). POSIX.1-1996 no aceptaba clearenv() ni putenv(), pero más tarde recapacitó y planificó estas funciones para ser incluidas en una versión posterior de su estándar (cf. B.4.6.1). Sin embargo, SUSv3 solo incorpora putenv(), y rechaza clearenv().

OBSERVACIONES¶

Utilizada en aplicaciones conscientes de la importancia de la seguridad. Si la asignación

	environ = NULL;

En las páginas de manual de DGUX y Tru64 se puede leer: Si environ ha sido modificado por cualquier otro medio que no sea las funciones putenv(), getenv(), o clearenv() entonces clearenv() devolverá un error y el entorno del proceso permanecerá intacto.

VÉASE TAMBIÉN¶

getenv(3), putenv(3), setenv(3), unsetenv(3), environ(5)